home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glindexpointer.z / glindexpointer
Encoding:
Text File  |  2001-04-17  |  11.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr((((3333GGGG))))             OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee             ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr - define an array of color indexes
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr( GLenum _t_y_p_e,
  14.                           GLsizei _s_t_r_i_d_e,
  15.                           const GLvoid *_p_o_i_n_t_e_r )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _t_y_p_e     Specifies the data type of each color index in the array.
  20.               Symbolic constants GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____IIIINNNNTTTT, GGGGLLLL____FFFFLLLLOOOOAAAATTTT,
  21.               and GGGGLLLL____DDDDOOOOUUUUBBBBLLLLEEEE are accepted. The initial value is GGGGLLLL____FFFFLLLLOOOOAAAATTTT.
  22.  
  23.      _s_t_r_i_d_e   Specifies the byte offset between consecutive color indexes.  If
  24.               _s_t_r_i_d_e is 0 (the initial value), the color indexes are
  25.               understood to be tightly packed in the array.  The initial value
  26.               is 0.
  27.  
  28.      _p_o_i_n_t_e_r  Specifies a pointer to the first index in the array.  The
  29.               initial value is 0.
  30.  
  31. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  32.      ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr specifies the location and data format of an array of
  33.      color indexes to use when rendering.  _t_y_p_e specifies the data type of
  34.      each color index and _s_t_r_i_d_e gives the byte stride from one color index to
  35.      the next allowing vertexes and attributes to be packed into a single
  36.      array or stored in separate arrays.  (Single-array storage may be more
  37.      efficient on some implementations; see ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss.)
  38.  
  39.      _t_y_p_e, _s_t_r_i_d_e, and _p_o_i_n_t_e_r are saved as client-side state.
  40.  
  41.      The color index array is initially disabled. To enable and disable the
  42.      array, call ggggllllEEEEnnnnaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee and ggggllllDDDDiiiissssaaaabbbblllleeeeCCCClllliiiieeeennnnttttSSSSttttaaaatttteeee with the
  43.      argument GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY. If enabled, the color index array is used when
  44.      ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss or ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt is called.
  45.  
  46.      Use ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss to construct a sequence of primitives (all of the same
  47.      type) from prespecified vertex and vertex attribute arrays.  Use
  48.      ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt to specify primitives by indexing vertexes and vertex
  49.      attributes and ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss to construct a sequence of primitives by
  50.      indexing vertexes and vertex attributes.
  51.  
  52. NNNNOOOOTTTTEEEESSSS
  53.      ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr is available only if the GL version is 1.1 or greater.
  54.  
  55.      The color index array is initially disabled, and it isn't accessed when
  56.      ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss, or ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss is called.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr((((3333GGGG))))             OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee             ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Execution of ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr is not allowed between ggggllllBBBBeeeeggggiiiinnnn and the
  75.      corresponding ggggllllEEEEnnnndddd, but an error may or may not be generated. If an
  76.      error is not generated, the operation is undefined.
  77.  
  78.      ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr is typically implemented on the client side.
  79.  
  80.      Since the color index array parameters are client-side state, they are
  81.      not saved or restored by ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb and ggggllllPPPPooooppppAAAAttttttttrrrriiiibbbb.  Use
  82.      ggggllllPPPPuuuusssshhhhCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb and ggggllllPPPPooooppppCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb instead.
  83.  
  84. EEEERRRRRRRROOOORRRRSSSS
  85.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is not an accepted value.
  86.  
  87.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _s_t_r_i_d_e is negative.
  88.  
  89. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  90.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY
  91.      ggggllllGGGGeeeetttt with argument GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY____TTTTYYYYPPPPEEEE
  92.      ggggllllGGGGeeeetttt with argument GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY____SSSSTTTTRRRRIIIIDDDDEEEE
  93.      ggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvv with argument GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY____PPPPOOOOIIIINNNNTTTTEEEERRRR
  94.  
  95.  
  96. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  97.      On RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems, do not enable or
  98.      disable GGGGLLLL____VVVVEEEERRRRTTTTEEEEXXXX____AAAARRRRRRRRAAAAYYYY, GGGGLLLL____VVVVEEEERRRRTTTTEEEEXXXX____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLL____AAAARRRRRRRRAAAAYYYY,
  99.      GGGGLLLL____NNNNOOOORRRRMMMMAAAALLLL____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY, GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT,
  100.      GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY,GGGGLLLL____IIIINNNNDDDDEEEEXXXX____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY,
  101.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDD____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT, GGGGLLLL____EEEEDDDDGGGGEEEE____FFFFLLLLAAAAGGGG____AAAARRRRRRRRAAAAYYYY or GGGGLLLL____EEEEDDDDGGGGEEEE____FFFFLLLLAAAAGGGG____AAAARRRRRRRRAAAAYYYY____EEEEXXXXTTTT
  102.      between a call to ggggllllNNNNeeeewwwwLLLLiiiisssstttt and the corresponding call to ggggllllEEEEnnnnddddLLLLiiiisssstttt.
  103.      Instead, enable or disable before the call to ggggllllNNNNeeeewwwwLLLLiiiisssstttt.
  104.  
  105.  
  106. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  107.      ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss,
  108.      ggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ggggllllEEEEnnnnaaaabbbblllleeee, ggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvv, ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss,
  109.      ggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ggggllllPPPPooooppppCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb, ggggllllPPPPuuuusssshhhhCCCClllliiiieeeennnnttttAAAAttttttttrrrriiiibbbb,
  110.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.